Метод IXMLStorageNode::GetChildNodeByAttributeValue

Возвращает экземпляр XML-узла по его имени и значению атрибута.

IDL

[id(109028)]
HRESULT GetChildNodeByAttributeValue(
    [in] BSTR ChildNodeName, 
    [in] BSTR AttributeName, 
    [in] BSTR AttributeValue, 
    [out, retval] IXMLStorageNode** Value
);

Параметры

Параметры	Описание
ChildNodeName	Имя узла
AttributeName	Имя атрибута
AttributeValue	Значение атрибута
Value	Возвращаемое значение

Возвращаемое значение

Экземпляр класса, реализующего интерфейс IXMLStorageNode.

Описание

Вызывает метод поиска подчиненного узла по его имени и значению атрибута (IXMLStorageNode::FindChildNodeByAttributeValue).

Если дочерний узел с указанными параметрами не найден в коллекции XML-узлов (IXMLStorageNode::Items), то он будет добавлен методом IXMLStorageNode::AddChildNode с атрибутом (AttributeName), значение которого (AttributeValue) будет установлено методом IXMLStorageNode::SetAttributeAsStr.

Метод всегда возвращает экземпляр класса, реализующего интерфейс IXMLStorageNode (найденный в коллекции IXMLStorageNode::Items или добавленный методом IXMLStorageNode::AddChildNode).

Примечания

№	Описание
1.	Поиск атрибута по имени является регистрозависимым.
2.	Поиск узла по имени является регистрозависимым.